Node / meshtastic / Meshtastic-Android / files / core / network / src / commonMain / kotlin / org / meshtastic / core / network / repository / SerialDevicePresence.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.core.network.repository

Tff7b72import T7ee787kotlinx.coroutines.flow.StateFlow

T8b949e/**

* Platform-abstracted view of currently-connected serial devices.

*

* Each key is the `rest` portion of an `InterfaceId.SERIAL` address (i.e. the address with its leading `'s'` prefix

* stripped) — exactly the keys that [UsbRepository.serialDevices] emits on Android.

*

* Consumed by transport-recovery code (notably `SharedRadioInterfaceService.initStateListeners`) to detect when a

* previously-selected serial device has been unplugged and replugged, so the transport can be brought back without

* manual re-selection.

*

* Platforms without hot-plug observation (e.g. JVM/Desktop jSerialComm) return a perpetually-empty set.

*/

Tff7b72interface T56d364SerialDevicePresence Tb4b4b4{

T8b949e/**

* The set of currently-connected serial device keys (the `rest` part of an `s$rest` SERIAL address).

*

* Implementations MUST emit a fresh set whenever the connected-device set changes. Equal sets MUST be deduped by

* the underlying [StateFlow] semantics so collectors do not observe redundant emissions.

*/

Tff7b72val Te6edf3deviceKeysTb4b4b4: Te6edf3StateFlowTff7b72<Te6edf3SetTff7b72<Tffa657StringTff7b72>Tff7b72>

Tb4b4b4}